package com.warom.sdg.dao;

import com.warom.sdg.model.UserEntity;

import java.util.List;

/**
 * 用户数据访问对象接口
 * 定义用户表的数据库操作方法
 */
public interface UserDao {
    
    /**
     * 插入一个用户
     * @param user 用户实体
     * @return 插入用户的ID
     */
    long insert(UserEntity user);
    
    /**
     * 更新用户信息
     * @param user 用户实体
     */
    void update(UserEntity user);
    
    /**
     * 删除用户
     * @param user 用户实体
     */
    void delete(UserEntity user);
    
    /**
     * 获取所有用户
     * @return 用户列表
     */
    List<UserEntity> getAllUsers();
    
    /**
     * 根据ID获取用户
     * @param id 用户ID
     * @return 用户实体
     */
    UserEntity getUserById(long id);
    
    /**
     * 根据用户名获取用户
     * @param username 用户名
     * @return 用户实体
     */
    UserEntity getUserByUsername(String username);
    
    /**
     * 验证用户登录
     * @param username 用户名
     * @param password 密码
     * @return 用户实体，如果验证失败则返回null
     */
    UserEntity verifyLogin(String username, String password);
    
    /**
     * 更新用户最后登录时间
     * @param id 用户ID
     * @param lastLoginTime 最后登录时间
     */
    void updateLastLoginTime(long id, long lastLoginTime);
    
    /**
     * 删除所有用户
     */
    void deleteAll();
} 